home *** CD-ROM | disk | FTP | other *** search
/ LOGIC 2000 February / LogicCd--feb.2000-mac-cdr.iso / Apple II / TWOQWKV2.03 / DOCS.V2.01 < prev    next >
Text File  |  1996-01-13  |  30KB  |  803 lines

  1.                     _________________________________________
  2.  
  3.                       2qwk! 2.01 (c) 1996 lysergic software
  4.                     _________________________________________
  5.  
  6.  
  7. Table of contents
  8.  
  9. Introduction............................0.00
  10. Installation............................1.00
  11. Preferences.............................2.00
  12.    archiver.............................2.10
  13.    directories..........................2.20
  14.    general..............................2.30
  15.    replies..............................2.40
  16.    hardware.............................2.50
  17. Using the program.......................3.00
  18. Archiver................................3.10
  19. Messages................................4.00
  20. Editor..................................5.00
  21. Utilities...............................6.00
  22. Miscellaneous...........................7.00
  23. Appendixes..............................8.00
  24.    troubleshooting......................8.01
  25.    sourcecode...........................8.02
  26.    fanmail..............................8.03
  27.  
  28.  
  29. 0.00    Introduction
  30.  
  31. 0.01    About the documentation
  32.  
  33.   Writing documentation sucks, which is why I've foisted much of the duties
  34.   off onto Mushroom.  [Coding sucks, which is why I let Tom do it. -m3]
  35.  
  36.   Throughout the document I've used some 'typographical aids' to highlight
  37.   information in the text:
  38.  
  39.    - a :?: following the text indicates a helpful hint.
  40.  
  41.    - a :!: indicates a helpful warning.
  42.  
  43. 0.02    About the 2qwk!
  44.  
  45.   The 2qwk is an offline mail reader for qwk mail systems. An offline reader
  46.   (olr) allows the user to download new messages and mail in a compact format
  47.   and read and reply to them offline. You save time and connection charges
  48.   by downloading a mail packet and logging off in a fraction of the time it
  49.   would take to read and reply to messages online.
  50.  
  51.   The program is now written in assembly language using a custom API to do
  52.   some of the grunt work that macos was used for in previous versions. This
  53.   results in a small, fast and efficient package that is sweet and slippery,
  54.   like a sheriff's bare red ass.
  55.  
  56.  
  57. 1.00    Installation
  58.  
  59. 1.01    The archive
  60.  
  61.   I've decided to skip the Zip archiver since the extra step was apparently
  62.   more than some people could take. If this is the first time you've used
  63.   the 2qwk you'll need to use the qfix program to modify your system files
  64.   to allow ms-dos filenames.  And there's no way around patching your system
  65.   files to use the 2qwk (trust me, it's safe) so don't even ask.
  66.  
  67. 1.02    The qfix
  68.  
  69.   New with 2qwk 2.0 is quickfix. To patch the system files on your boot
  70.   device (named in this example) '/gopshill' you would do:
  71.  
  72.    'qfix /gopshill/system' (if run from a shell environment)
  73.  
  74.    or if not running from a shell environment like Davex:
  75.  
  76.    'qfix' (wait for the prompt, then) '/gopshill/system'
  77.  
  78.   Read the qfix documentation for a better understanding of this swell new
  79.   program (and how to patch your other files).
  80.   
  81. 1.03    The install
  82.  
  83.   After you've unpacked all the archive files, you need to run the Install
  84.   program to initially configure the 2qwk. This does some one-time stuff and
  85.   can be deleted after it has run. It automatically launches the 2qwk after
  86.   it's finished.
  87.  
  88.   :!:  The install program checks to see if'n prodos has been patched (and
  89.        it don't work if it hasn't).  Use qfix before trying to install!
  90.  
  91.   :?:  Some people have had problems in the past with the name of the program
  92.        (2qwk!) when working with old programs that don't let the file system
  93.        do its job and determine if a filename is valid. To this end you can
  94.        now rename the 2qwk! file to whatever you like after the installation.
  95.  
  96. 1.04    The required external programs
  97.  
  98.   You'll need a program to extract the zip archives that the qwk packet is
  99.   made of. Either Angel .81b or PMPUnzip 2.0 will work.
  100.  
  101.   :?: The 2qwk is set up to run the archiver (see section 2.10) when you
  102.       select Archiver from the main menu. When you exit the archiver it
  103.       will return to the 2qwk.
  104.  
  105.   :!: Angel needs to be patched to keep it from sanitizing filenames. You
  106.       can use qfix to do this:
  107.  
  108.        'qfix /gopshill/archivers/angel.system'
  109.  
  110. 1.05    Modified Angel  (qfix's ANGLE patch)
  111.  
  112.  In addition to not sanitizing filenames, it is possible to modify Angel to
  113.  be a bit more 2qwk friendly. You should use qfix your angel.system file with:
  114.  
  115.        'qfix /gopshill/archivers/angle'
  116.  
  117.  This will do the following:
  118.  
  119.   - Skip the splash screen (Cmd-? is disabled).
  120.  
  121.   - Preset the source (rep) and destination (qwk) directories.
  122.  
  123.   - Allow Cmd-Rtn to process all the files in the archive and automatically
  124.     exit back to the 2qwk (Cmd-Down is removed).
  125.  
  126.  The best way to utilize this is to have a single transfer directory that you
  127.  use for uploads and downloads. Set your Rep directory (see section 2.22) to
  128.  this. When you launch the archiver from 2qwk, the pathnames are set so all
  129.  you have to do is open the qwk packet, press Cmd-Rtn, and when it is done
  130.  unpacking it will exit back to the 2qwk and the packet will be loaded.
  131.  
  132.  :?: This is unauthorized, but I figure it betters two years of nothing :).
  133.  
  134. 1.06    System requirements
  135.  
  136.  You need at least a 128k enhanced //e (or equivalent) running ProDOS 8
  137.  2.0.x that has been enhanced to allow ms-dos filenames (via quickfix).
  138.  
  139.  
  140. 2.00    Preferences
  141.  
  142.  After you have installed and run the program, you will probably want to
  143.  set your personal preferences. To do this, use the arrow keys to move the
  144.  highlight bar to the 'preferences' command and press the return key.
  145.  
  146.  :?: You select commands in the program by using the arrow keys or the
  147.      keypad to highlight the command and press return. You can also usually
  148.      enter the first letter of the command to directly execute that command.
  149.  
  150. 2.10    Archiver
  151.  
  152.  The 2qwk can launch your favorite archiver for you from the main menu;
  153.  this is where you enter the pathname and filename information.
  154.  
  155. 2.20    Directories
  156.  
  157.  This command lets you set the pathnames that the program will use to locate
  158.  specific files.  If you do not specify a path, the 2qwk program path 
  159.  defined by the install will be used.
  160.  
  161.  :?: If you're using floppies you might want to set these directories to
  162.      another (ram?) disk.
  163.  
  164.  :?: Shortcut prefixes are available!  To access any files in a given path,
  165.      you can use the character instead of the full pathname (e.g. 1/welcome).
  166.  
  167.       @/  represents the 2qwk /data subdirectory
  168.       1/  represents the qwk directory (see 2.21)
  169.       2/  represents the rep directory (see 2.22)
  170.  
  171.  :!: All files used by the 2qwk now reside in the /data subdirectory. These
  172.      include iiqwk.tag, iiqwk.sig, launch.lst, picklists, whatever.
  173.  
  174. 2.21    QWK directory        | ../qwk/
  175.  
  176.  This is where 2qwk expects to find the contents of the QWK packet that you
  177.  have downloaded.
  178.  
  179.  :!: You may use a RAM disk as the qwk directory if you have more than 128k
  180.      of RAM but no hard drive, or if you prefer lotsa speed and volatility.
  181.  
  182. 2.22    REP directory        | ../rep/
  183.  
  184.  This is where the program stores the replies that you have written. When you
  185.  exit the program, the replies are "stored" in 'bbsid.rep', a zip-compatible
  186.  archive. If you quit the program and choose to save your replies, it will also
  187.  contain BBSID.MSG.
  188.  
  189.  :?: The bbsid parameter is an identifying token chosen by the host that you
  190.      picked up the packet from.
  191.  
  192.  :?: You might want to set this directory to your term program's default upload
  193.      directory (recommended).
  194.  
  195. 2.30    General
  196.  
  197.  These options apply to either those functions that apply throughout the entire
  198.  program, or those that don't fit elsewhere.
  199.  
  200. 2.31    Blink rate      | (varies)
  201.  
  202.  The 2qwk now uses a flashing cursor when entering text; this sets the speed
  203.  at which it flashes. A larger number indicates a longer delay.
  204.  
  205.  :?: The install program attempts to set the number based on your machine type
  206.      and whether you have a twgs or not. Try MHz x 8.
  207.  
  208. 2.32    Index           | long
  209.  
  210.  The message selection dialog can either show a short index (subject, date,
  211.  and time) or a long index (subject, from, and to).
  212.  
  213.  :?: You can toggle this (for this session) by hitting '-' in the message
  214.      selection dialog.
  215.  
  216. 2.33    Load type       | overstrike
  217.  
  218.  When importing text from disk (section 5.01), you can either have the stuff
  219.  overwrite what is in the editor below the cursor (if anything) or be inserted
  220.  at that point, moving everything below the cursor down. Whichever you choose
  221.  here, you can do the opposite when importing by holding down the Command key
  222.  while the text loads, so pick what you think you'll do most often here.
  223.  
  224.  :?: Due to the way the editor is designed inserting text into the middle of
  225.      a long file can be painfully slow. You have been warned.
  226.  
  227. 2.34    Support qwke    | on
  228.  
  229.  This enables the program to support addresses (to:) and subjects that are
  230.  longer than 25 characters. If you never read messages from a qwke compliant
  231.  host or internet-style headers you should turn this off.
  232.  
  233. 2.40    Replies
  234.  
  235.  The replies command will let you change aspects of the program that relate
  236.  to replying to (or entering) messages.
  237.  
  238. 2.41    Add initials    | on
  239.  
  240.  This command will toggle whether or not the program will show the initials
  241.  of the person you're quoting. "SS> Hello". Like that.
  242.  
  243.  :?: This helps to identify who the text is from and the alternative is a bare
  244.      reply character, ">".
  245.  
  246. 2.42    Fido compliant  | on
  247.  
  248.  This determines whether the program uses fido compliant taglines or not,
  249.  it's usually a good idea anyway.
  250.  
  251. 2.43    Message header  | on
  252.  
  253.  When this setting is on, the program will add a small header to the beginning
  254.  of your reply.
  255.  
  256.  :?: If you hold down the command (open-apple) key while selecting this option
  257.      you will be able to edit the message header string. You can use any text
  258.      you like, along with these variables:
  259.  
  260.       @@a  address of message sender (see below).
  261.       @@d  date the message was written (01-01-95).
  262.       @@f  who the message was written by.
  263.       @@l  alternate date format (Jan 01, 1995).
  264.       @@m  carriage return (see below).
  265.       @@p  aligns the second line of a tagline.
  266.       @@s  subject of the message.
  267.       @@t  who the message was written to.
  268.       @@1  first name of message sender.
  269.  
  270.      The default string is "Hello @@1,@@m@@mOn @@d, @@f writes to @@t:" which
  271.      when it reads the header "from: Earl Wade" renders something like:
  272.  
  273.         Hello Earl,
  274.  
  275.         On 07-04-95, Earl Wade writes to All:
  276.  
  277.      You may have to do some tweaking in the message if you are reading an
  278.      Internet conference ("Hello earlwade@netgoof.com, ...").
  279.  
  280.  :?: You can be artistic with @@m; you can create Bill The Cat by using the
  281.      string (without the quote-marks): "_   /|@mm\'o.O'@mm=(___)=@mm   U".
  282.  
  283.  :?: @@a will take the address from qwke (qwke must be on in Preferences);
  284.      if there ain't no address or qwke is turned off, it will print the name
  285.      from the qwk header.  If you use a reply header of '@@a wrote:' and turn
  286.      off the initials it will format the reply similar to what your average
  287.      newsreader gives.
  288.  
  289. 2.44    Quoting style   | reply-character
  290.  
  291.  There are three basic styles of quoting. As you might imagine, 'none' turns
  292.  off quoting. The 'raw-text' mode puts the text in the editor more or less as
  293.  it is in the message. The 'reply-character' mode prefaces all text from the
  294.  message with the Fido standard " SS> " deal.
  295.  
  296.  :?: The editor employs flowyquoting(tm) to ensure that the message text is
  297.      left in a readable state after it has been quoted.
  298.  
  299.  :?: Command-R will let you change the quoting character. It really should be
  300.      left as '>' though.
  301.  
  302. 2.45    Taglines        | on
  303.  
  304.  Do you want to use taglines? Sure you do, that's why you're using an offline
  305.  reader!
  306.  
  307.  :?: The @@ variables (see section 2.43) can also be used in taglines.
  308.  
  309.  :?: Command-T will let you customize the string that the tagline stealing
  310.      routine uses to rip taglines. The program looks for the four characters
  311.      that are in positions 3-7 on a line.
  312.  
  313.      * OLX 1.52 * I like spam almost as much as my PC.
  314.        ^^^^
  315.  
  316.      So you would add 'OLX ' if you wanted to rip OLX tags and it wasn't
  317.      already supported.
  318.  
  319. 2.46    Editor width    | 74
  320.  
  321.  You can set the right margin in the editor. This is useful for boards which
  322.  have narrow message widths. The default should be sufficient for most boards.
  323.  
  324. 2.50     Hardware
  325.  
  326.  The 2qwk needs a little more information about your system if you want it
  327.  to print messages or operate a mouse on a non-GS.
  328.  
  329. 2.51     Clock           | on
  330.  
  331.  This refers to the clock in the upper right corner, not your computer's own
  332.  clock. If you don't like it, turn it off.
  333.  
  334.  :?: If your clock requires a driver, run it before launching 2qwk.
  335.  
  336. 2.52     Linefeeds       | off
  337.  
  338.  Not all printers are created equal.  Yours may or may not need the computer
  339.  to throw it linefeeds (lf after cr) to make it advance to the next line.
  340.  Try printing a message, after setting the slot and init string (2.54-2.55),
  341.  and the results should clue you in. 
  342.  
  343. 2.53     Mouse           | (varies)
  344.  
  345.  If the install program detects a mouse card this defaults to on. If you
  346.  would rather not use one you can turn it off. The 2qwk will automatically
  347.  recognise a GS mouse; a mouse on a //e (in slot 4) or a //c will also be
  348.  noticed by the installer.
  349.  
  350.  :?: If you insert a mouse card in your //e after installation or the mouse
  351.      card is in a different slot than 4, tell the program what slot it is in
  352.      by hitting Command-M.
  353.  
  354.  :!: Do not meddle with Command-M under any other circumstances or you will
  355.      have to re-install the program completely. If you accidentally typed
  356.      that keystroke and get "slot: 0", hit escape immediately!
  357.  
  358. 2.54     Printer slot    | 0
  359.  
  360.  If you have a printer, enter the slot the interface card is in here.  If
  361.  you don't, try not to hit "p" while reading a message.
  362.  
  363. 2.55     Printer init string <not shown>
  364.  
  365.  Your printer may need specific instructions on how to do what you want. Or
  366.  maybe you want to do something special, like boldface everything or print
  367.  in French (on the Imagewriter). Your owner's manual should tell you what
  368.  to do; neither the author of 2qwk! or of the docs knows much about printers.
  369.  You set the init string by hitting Control-P and entering the info. Control
  370.  characters are inputted as ^-whatever (control-I is rendered ^I).
  371.  
  372.  :?: The generic 80-column printer initialization is "^I80N"
  373.  
  374.  
  375. 3.00     How to use the program
  376.  
  377.  Every effort has been made to make this program as easy to use as possible,
  378.  but reading through the rest of the manual can only help.
  379.  
  380.  Using the mouse is pretty straight-forward. If you put your mouse cursor on
  381.  an item and click on it, it will act as though the item was selected and you
  382.  had pressed return.
  383.  
  384. 3.01    The qwk packet
  385.  
  386.  Due to the general lack of shell-style archivers (and no desire on my part
  387.  to write one) the program expects you to have already placed the contents of
  388.  a qwk packet into the qwk directory (see 2.21).
  389.  
  390.  :?: A good compromise around this (what I do anyway) is to use Angel with the
  391.      angle patch (see 1.05). You can also:
  392.  
  393.      a) Run the 2qwk without extracting the packet.
  394.      b) Hit enter on Archiver to launch your archiver.
  395.      c) Extract the packet.
  396.      d) Exit the archiver (which relaunches 2qwk and loads the packet).
  397.  
  398. 3.02    How to use the menus
  399.  
  400.  All menus and lists in dialogs are navigated by using the Up and Down arrows
  401.  to highlight the item, and Return to select it. You can also use the keypad.
  402.  
  403. 3.03    How to use dialogs
  404.  
  405.  All dialogs use Return to accept and Escape to abort. Special dialogs will be
  406.  covered on their own.
  407.  
  408. 3.04    How to use picklists
  409.  
  410.  A picklist is a <cr> terminated text file that contains items which will be
  411.  commonly used. It is then called by pressing (in a line edit event, such as
  412.  while in the edit file dialog) Option and the file identifier.
  413.  
  414.         File: @/picklista (Option-A or closed-apple-A)
  415.  
  416.         tom.larson@pcwash.com
  417.         spamboy@spamluv.com
  418.         brian.hammack@rook.wa.com
  419.  
  420.  This brings up those items in a boxed menu. After you pick the item that you
  421.  wish to use (or escape to not choose any) you proceed with the dialog as if
  422.  you had typed that information in yourself.
  423.  
  424.  This is useful for email addresses, pathnames, search criteria, taglines or
  425.  whatever you want to use it for. 
  426.  
  427.  :!: There is a limit of 50 items which can contain 2k of data.
  428.  
  429. 3.05    Online help
  430.  
  431.  An online help system is available in major areas of the program by pressing
  432.  the '?' key. If the title bar contains numbers then the corresponding sub-
  433.  screens may be viewed by pressing that key.
  434.  
  435.  :?: If you never view the help stuff you can save a few kilobytes by removing
  436.      the @/help file.
  437.  
  438. 3.06    Bulletins
  439.  
  440.  The nature of bulletins are so generally worthless that I yanked support from
  441.  this release. If anyone can come up with a valid reason (hah!) to have them
  442.  added back, I'll do it.  Same story with News and Files, they're gone.  Also
  443.  missing is the logon/logoff message toggle in Preferences (some boards send
  444.  texts so you can pretend you are online when you are offline, what fun).
  445.  
  446. 3.07    Packing replies
  447.  
  448.  The active replies are stored in a pkzip compatible archive when you exit the
  449.  program. This could be a lot faster but having to deal with deleted messages
  450.  really slows things down. To keep things exciting, the crc-32 is displayed
  451.  while the replies are being processed.
  452.  
  453.  :?: The crc32 routine is by Neil Parker.
  454.  
  455. 3.10    Archiver
  456.  
  457.  This main menu selection will launch the archiver you specified in the
  458.  Preferences (see 2.10). It's the first thing you will want to do when you
  459.  get a new QWK packet if you use the startup method listed in section 1.05.
  460.  
  461.  :?: If the 2qwk doesn't find the qwk file "control.dat" on startup, you 
  462.      will get a dialog box (hit return), and the Archiver option will
  463.      automatically be highlighted. If it does find that file (old or new)
  464.      the Messages option will be highlighted instead. 
  465.  
  466. 4.00    Messages
  467.  
  468. 4.10    The conference selection dialog
  469.  
  470.  This is the dialog you get when you select the messages item from the main
  471.  menu. It displays the first 32 conferences, next to each conference it shows
  472.  how many messages are available.
  473.  
  474. 4.11    Dialog specific commands
  475.  
  476.         '+'/'-' Move to the next and previous conferences, respectively, with
  477.                 messages (also Cmd-Rt & Cmd-Lft)
  478.  
  479.         'a'     Add conference (if host supports offline configuration).
  480.         'd'     Drop conference
  481.         'e'     Enter a new message in selected conference.
  482.  
  483. 4.12    Special conferences
  484.  
  485.         Replies         Messages which you have written.
  486.         Personal        Messages addressed to you.
  487.  
  488. 4.20    The message index dialog
  489.  
  490.   When you select a conference that has messages, the program will display
  491.   this dialog. It shows an index of the first 16 messages with information on
  492.   either the date and time or the author and intended recipient.
  493.  
  494. 4.21    Dialog specific commands
  495.  
  496.         '-'     Toggle between short and long index (see 2.23)
  497.         '3'     Show next 16 messages (also command-down)
  498.         '9'     Show previous 16 messages (also command-up)
  499.  
  500. 4.22    Additional commands for replies conference
  501.  
  502.         'c'     send a carbon-copy of this reply.
  503.         'd'     delete (and undelete) this reply.
  504.         'r'     re-edit this reply.
  505.  
  506. 4.22.1   Carbon copy
  507.  
  508.  You can send carbon copies of replies other people or conferences. If the
  509.  message has qwke routing info (a To: line) you should use 'r' to edit the
  510.  reply and then undelete the original.
  511.  
  512. 4.22.2   Delete/undelete reply
  513.  
  514.  Useful if you decide you don't want to send a message afterall, or want to
  515.  reanimate a killed message.
  516.  
  517. 4.22.3   Re-edit reply
  518.  
  519.  Say you came up with the answer you were seeking at the end of a session to
  520.  a question you'd replied to at the beginning of your reading. You don't have
  521.  to send two messages, you can edit the one you've already sent.  This option
  522.  is also helpful if you accidentally saved your reply before you were 
  523.  finished writing it (Ctrl-W is close to Ctrl-E, yes?).  This happens a lot.
  524.  
  525. 4.30    Reading messages
  526.  
  527.  The entire message is loaded into memory allowing you to scroll through the
  528.  message text by using the Up and Down arrow keys. You can move back and forth
  529.  through the messages in a conference by using the Left and Right arrow keys.
  530.  
  531.  You can also use the mouse. Clicking on the top two lines of the screen will
  532.  scroll up, on the bottom two will scroll down. Clicking on the left side of
  533.  the screen will take you to the previous message and on the right will take
  534.  you to the next message. Click on the message text to exit to the message
  535.  index dialog.
  536.  
  537.  After you have finished reading all messages in a conference you will exit to
  538.  the conference selection dialog and it will move to the next conference that
  539.  contains messages.
  540.  
  541. 4.31    The export command      (e)
  542.  
  543.  This command will export the message text to file. If the file exists it will
  544.  append the text to the end of the file.
  545.  
  546.  :?: If you don't specify the pathname it will save to the directory where
  547.      the 2qwk resides. The special prefixes (see 2.20) also can be used.
  548.  
  549. 4.32    The find command        (f)
  550.  
  551.  The find function searches through the messages in the conference and will
  552.  display the first that contains the specified text. This is especially useful
  553.  in conferences with lots of traffic. It is not case-sensitive. While you're
  554.  waiting for the program to grind through all the data, a spinning cursor is
  555.  provided to amuse you.
  556.  
  557.  :?: You can search for more than one item by seperating them with a semi-
  558.      colon. For example 'john;scully;sucks' would find any message that
  559.      contained 'john', 'sculley' or 'sucks'.
  560.  
  561. 4.32    The find next command   (g)
  562.  
  563.  Use this to find the next iteration of the find sequence without bringing
  564.  the find dialog back up.
  565.  
  566. 4.33    Add user to kill file   (k)
  567.  
  568.  Sometimes you'll find messages by a dimbulb or just plain take a dislike
  569.  to a particular person and not want to see messages from them. Hey, put
  570.  away that ak-47 and just add them to your kill file. This puts them into
  571.  a file (@/twit.bbsid) that ensures you'll never see another message
  572.  originating from them.  You'll still see replies to the dork, however.
  573.  
  574.  :?: You can clear the kill file by using K from the main menu. You can
  575.      edit it by using Cmd-K.
  576.  
  577. 4.34    The reply command       (r)  
  578.  
  579.  This brings up the reply dialog. You can press Return to accept the default
  580.  items and move to the editor (see 5.0), or:
  581.  
  582. 4.34.1  Edit reply dialog       (e)
  583.  
  584.  This allows you to edit:
  585.  
  586.    Conf: Which conference the message will be posted in.
  587.      To: Who the message will be addressed to.
  588.    Subj: The subject of the message.
  589.    Priv: Should the message be flagged as private (yes) or public (no).
  590.     Tag: Write your own.
  591.  
  592. 4.34.2  New random tagline      (t)
  593.  
  594.  Picks a new tagline at random.
  595.  
  596. 4.34.3  Next tagline            (right)
  597.  
  598.  Moves to the next tagline in the file (wraps to 0).
  599.  
  600. 4.34.4  Previous tagline        (left)
  601.  
  602.  Moves to the previous tagline (wraps at 0).
  603.  
  604. 4.35    Steal tagline           (s)
  605.  
  606.  Stealing taglines is not an exact science. This is why I've implemented
  607.  tagboy(tm), the configurable tagline stealer. This allows the 2qwk to adapt
  608.  to virtually any other mail readers signature line (see 2.45).
  609.  
  610.  :?: The tagboy(tm) comes preconfigured to steal taglines for OLX, SLMR, TLX,
  611.      KingQWK, 2qwk!, OFFLINE and those preceded by '...'.
  612.  
  613.  :?: You can edit the tagline search string (for this session) without going
  614.      to prefs:rep by using Command-T; see 2.45 for what it scans for already.
  615.  
  616. 4.36    Print message           (p)
  617.  
  618.  Now you can throw the message you're reading to the printer without having
  619.  to export it and print it with another program (unless you want to)! 
  620.  
  621.  :?: Print drivers
  622.  
  623.      I don't have a printer, or any reference materials for one, so I'm
  624.      using a really generic driver. I'm also providing the commented source
  625.      for the driver so you can write your own, better driver, if you feel
  626.      like it.
  627.  
  628.  :!: You must have set all the vital data in the prefs:hardware department
  629.      (see 2.5) for this to work. You must also have a printer online, duh. 
  630.  
  631. 5.00    The editor
  632.  
  633.  This editor is based on the blackspring editor that was originally written
  634.  by Ron Mercer (which means that it is memory hungry and line oriented) and
  635.  yes it is on top of my list for things to rewrite.
  636.  
  637.  :!: Some boards impose size limits to messages (a certain number of lines
  638.      or kilobytes per message), and like the width (see 2.36) you should
  639.      know what a board's limits are before posting messages with 2qwk.
  640.  
  641.  The commands (command-?) are pretty self-explanatory, but some of the more
  642.  complicated are:
  643.  
  644. 5.01    Importing text          (ctrl-l)
  645.  
  646.  This imports text at the cursor position. You can drag in binscii's and
  647.  incriminating text from disk at will, where you want it. The setting in
  648.  prefs:general:load type (see 2.33) selects whether imported text overwrites
  649.  or is inserted (forcing everything below the cursor down).
  650.  
  651.  :?: The text is processed through the flowyquoter for more prettyness.
  652.  
  653.  :?: You can change how text is imported by holding down the open-apple
  654.      key during loading (does the opposite of the prefs setting).
  655.  
  656.  :!: The limit on length of imported text, or a message in general, is ~525
  657.      lines.  Text beyond that point will not be loaded into the editor.
  658.  
  659. 5.02    Re-edit reply dialog    (Command-N)
  660.  
  661.  Lets you go do the stuff listed in 4.34.1 over while in the message editor.
  662.  Handy if you suddenly decide to change the conference number (which happens
  663.  often when you're trying to make a private-email reply to a public-only
  664.  conference), and faster than editing a message you've already saved to the
  665.  Replies conf or bailing out of the message and starting over.  
  666.  
  667.  :?: If you're just editing a text file, this allows you to save it to a
  668.      new filename.
  669.  
  670. 5.03    The signature file      (@/iiqwk.sig)
  671.  
  672.  If it exists, the editor will append the contents of the signature file onto
  673.  the end of your messages. Create one with the editor (see 7.1) if you dare.
  674.  
  675.  :?: Use command-w or command-s to avoid adding the signature file.
  676.      Use control-w or control-s to save your message with the signature.
  677.  
  678.  
  679. 6.00    Utilities
  680.  
  681.  These are pretty much completely different from previous versions.
  682.  
  683. 6.10    Import taglines
  684.  
  685.  This allows you to import taglines from <cr> terminated files into your own
  686.  iiqwk.tag file. Treat it like any other dialog (Rtn accepts, Esc aborts) with
  687.  the Down arrow skipping the current tagline. Hold down the command key while
  688.  accepting the tagline to process all remaining taglines automatically.
  689.  
  690.  :?: By using a set tagline size it drastically speeds up tagline manipulation,
  691.      this might change in future versions but probably not.
  692.  
  693. 6.20    Make ndx files
  694.  
  695.  This creates the .ndx files (which the 2qwk needs) from the messages.dat file
  696.  in the qwk packet.  If you didn't get .ndx files in your qwk, use this.
  697.  
  698.  
  699. 7.00    Miscellaneous
  700.  
  701. 7.10    Editing text files      (E from main)
  702.  
  703.  This command lets you create or edit textfiles.  All the message editor rules
  704.  you've read about so far are in effect here as well.
  705.  
  706.  :?: You can change the name of the file you're editing by pressing Command-N
  707.      in the editor.
  708.  
  709. 7.20    Launch programs         (L from main)
  710.  
  711.  This command brings up a list of programs to run. Replies will *not* be
  712.  processed into the bbsid.rep file (because all programs will quit to the 
  713.  2qwk when you exit) unless you hold down the Command key while launching.
  714.  
  715.  :?: You can edit the launch list by using Command-L from the main menu or
  716.      the text editor (@/launch.lst).
  717.  
  718.  :!: You can run s16 programs if you have launched the 2qwk from gs/os but
  719.      won't automatically return because I have no idea how to do that.
  720.  
  721. 7.30    View text files         (T from main)
  722.  
  723.  This command lets you view files (see 4.3 for commands).
  724.  
  725.  :?:  This will view up to the first ~43k.
  726.  
  727. 7.40    Re-read packet          (Y from main)
  728.  
  729.  This reprocesses the contents of the qwk directory. It's useful if you have
  730.  changed it (see 2.21).
  731.  
  732.  
  733. 8.00    Appendices
  734.  
  735. 8.01    Troubleshooting
  736.  
  737.  What needs to go in the qwk directory?
  738.  
  739.         messages.dat    Contains the messages.
  740.         control.dat     BBS information, conference names.
  741.         *.ndx           File position information for the messages.
  742.         door.id         If you want to do offline configuration.
  743.  
  744.  :!: You will need the ndx files (see 6.20 if you mail host can't create them).
  745.  
  746.  In general:
  747.  
  748.   - Unpack all files to the same directory.
  749.  
  750.   - Make sure that you've installed the qfix patches on all programs that
  751.     need them.
  752.  
  753.  Install don't work:
  754.  
  755.   - You are using a patched version of ProDOS-8 2.0.x, right?
  756.  
  757.   - Make sure that you have free space on the disk that you have installed
  758.     the 2qwk on -- at least 50 blocks must be available.
  759.  
  760.  I get a 'control.dat not found' error message:
  761.  
  762.   - Make sure you set your qwk & rep directories correctly.
  763.  
  764.   - Use the Archiver to unpack the QWK data.
  765.  
  766.  The packet info comes up but no messages:
  767.  
  768.   - Make sure the mail door is sending the ndx files. If your mail door
  769.     isn't capable of doing this you can use the 'make ndx files' utility.
  770.  
  771.   - Make sure your archiver is patched or the ndx files will have their
  772.     named corrupted.  They should have names like "025.NDX".
  773.  
  774.  The rep packet don't get made:
  775.  
  776.   - Make sure you quit the program normally.
  777.  
  778.  I can't get no date:
  779.  
  780.   - Do not display your box of condoms during dinner at the DQ.
  781.  
  782.   - Stop doing Beavis & Butt-head imitations when asked a question.
  783.  
  784.   - Invest in Head & Shoulders, not Brylcreme.
  785.  
  786.   - Never introduce yourself as "that guy who got sick all over your friend
  787.     Stacy".
  788.  
  789. 8.02    Source code
  790.  
  791.  The source code for this program is available on request.
  792.  
  793.  :?: It's not that I've changed my mind on distribution of source, but it's
  794.      not worth clogging up phone lines for something maybe 5 people will
  795.      ever want to see.
  796.  
  797. 8.03    Reaching the author or getting help
  798.  
  799.  Comments or suggestions can be directed towards:
  800.  
  801.         tom.larson@pcwash.com           (sometimes goofy)
  802.         brian.hammack@rook.wa.com       (documentation & user help)
  803.